home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Developer Toolbox 6.1
/
SGI Developer Toolbox 6.1 - Disc 4.iso
/
public
/
jpeg
/
libCLRjpeg4
/
README
< prev
Wrap
Text File
|
1994-08-01
|
4KB
|
122 lines
JPEG for SGI Iris GL (release 1.02)
------------------------------------
January 4, 1993
(c) 1992,1993 Rodney Hoinkes, Centre for Landscape Research
email: rodney@dgp.utoronto.ca
jpaste & jsave are IRIS GL programs for the capture
and viewing of jpeg files.
In this library, you will find the following
organization:
bin/ - binaries of utilities and examples
src/ - source code to CLR additions as
well as basic library object files
and header files:
include4/ & JPEGobj4/ are for v4 of
the JPEG library
examples/- sample source code built on the library
a screen saving 'jsave' and an image
display program 'jpaste'
CLRjpegExtern.h
- contains the function definitions within
the CLR JPEG library extentions.
NOTE: Within src/include4 are two
files, README.JPEG and USAGE.JPEG which include the
information of legalities of using this code as well
as issues of the JPEG format and quality concerns.
PLEASE READ THESE FILES!
This library has been compiled using
ANSI C and does not include the
ansi2knr.c code which has certain
licensing conditions.
The provided executables were
compiled under IRIX 3.3.2 and should
be upwardly compatible to IRIX 4.0.x
system versions. They have been tested on
IRIX 3.3.[0-2], 4.0.[145]
PI 20TG, 25TG, 70GT, 310VGX, Entry Indigo.
All of the jpeg code which comprises the
src/JPEBobj4 files has NOT been included. The
necessary .h files and sample code for reading and writing the
files is included.
If you wish the code that was used to create this library,
check your favorite ftp sites or use the
archie servers to find one that has it.
the JPEGobj4 and include4 directories are based upon:
jpegsrc.v4.tar.Z
This release is intended to be simple for people
to work with and integrate into their existing
or new code. It is NOT supported by me. I am
releasing it for general consumption and use at
your own risk blah blah blah.
The only restrictions on use are those
stated with the original library and found within
the README.JPEG and USAGE.JPEG files.
Good Luck and enjoy the disk space savings!!
Procedures Accessable through libCLRjpeg4.a:
--------------------------------------------------------------------------
extern unsigned long *LoadJPEGImagePtr(char *name,int *xsize,int *ysize);
this procedure accepts the name of a jpeg file which it will load
into a chunk of memory suitable for lrectwrite operations. This pointer
will be returned by the procedure as well as updating an xsize and ysize
variable passed to it defining the size of the image. If an error occurs,
the procedure will return a NULL pointer.
--------------------------------------------------------------------------
extern void LoadJPEGImageScreen(char *name, int sx, int sy);
this procedure accepts the name of a jpeg file which will be displayed
on screen, with its lower-left corner at sx,sy.
--------------------------------------------------------------------------
extern void SaveJPEGImagePtr(char *name, unsigned long *data, int xsize, int ysize);
this procedure will save out an lrect format image block in 24bit jpeg
colour to the file specified by name.
--------------------------------------------------------------------------
extern void SaveJPEGImageScreen(char *name, int x1,int y1,int x2,int y2);
this procedure will save out a section of the screen to a 24bit jpeg
colour image with the specified name.
--------------------------------------------------------------------------
extern char *GetJPEGVersion();
this procedure will return the verion number and date of the jpeg library.
--------------------------------------------------------------------------
Changes in v1.01:
-----------------
Thanks to Eric Williams of SGI for some bug fixes
and enhancements to this implementation. This
version supercedes his implementation of 'jpaste'
which was based upon v2 of the JPEG library.
Changes in v1.02:
-----------------
The official v4 release of the JPEG library has been
incorporated to fix any v3b problems. Code compatibility
should remain the same. CLR additions have been made to
allow easier integration of the JPEG into your existing
GL code. lrectread/write format can be loaded and/or
saved without going to screen, and/or loads/saves can
be performed right to/from the framebuffer. I hope these
new wrappings on the code make it easier to incorporate
for people. If you like the new wrapping better, let me
know!